home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.3 / InternAtom.3 < prev    next >
Text File  |  1995-07-25  |  4KB  |  67 lines
  1.  
  2.  
  3.  
  4.      TTTTkkkk____IIIInnnntttteeeerrrrnnnnAAAAttttoooommmm((((3333))))             TTTTkkkk (((( ))))              TTTTkkkk____IIIInnnntttteeeerrrrnnnnAAAAttttoooommmm((((3333))))
  5.  
  6.  
  7.  
  8.      _________________________________________________________________
  9.  
  10.      NNNNAAAAMMMMEEEE
  11.           Tk_InternAtom, Tk_GetAtomName - manage cache of X atoms
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           ####iiiinnnncccclllluuuuddddeeee <<<<ttttkkkk....hhhh>>>>
  15.  
  16.           Atom
  17.           TTTTkkkk____IIIInnnntttteeeerrrrnnnnAAAAttttoooommmm((((_t_k_w_i_n, _n_a_m_e)
  18.  
  19.           char *
  20.           TTTTkkkk____GGGGeeeettttAAAAttttoooommmmNNNNaaaammmmeeee((((_t_k_w_i_n, _a_t_o_m)
  21.  
  22.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  23.           Tk_Window   _t_k_w_i_n    (in)      Token for  window.   Used  to
  24.                                          map  atom or name relative to
  25.                                          a particular display.
  26.  
  27.           char        *_n_a_m_e    (in)      String name for which atom is
  28.                                          desired.
  29.  
  30.           Atom        _a_t_o_m     (in)      Atom for which  corresponding
  31.                                          string name is desired.
  32.      _________________________________________________________________
  33.  
  34.  
  35.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  36.           These  procedures  are  similar  to  the   Xlib   procedures
  37.           XXXXIIIInnnntttteeeerrrrnnnnAAAAttttoooommmm  and  XXXXGGGGeeeettttAAAAttttoooommmmNNNNaaaammmmeeee.   TTTTkkkk____IIIInnnntttteeeerrrrnnnnAAAAttttoooommmm  returns the
  38.           atom identifier associated with string given by  _n_a_m_e;   the
  39.           atom  identifier  is  only  valid for the display associated
  40.           with _t_k_w_i_n.  TTTTkkkk____GGGGeeeettttAAAAttttoooommmmNNNNaaaammmmeeee returns  the  string  associated
  41.           with  _a_t_o_m  on  _t_k_w_i_n's  display.   The  string  returned by
  42.           TTTTkkkk____GGGGeeeettttAAAAttttoooommmmNNNNaaaammmmeeee is in Tk's storage:  the caller need not free
  43.           this  space  when  finished  with the string, and the caller
  44.           should not modify the contents of the returned  string.   If
  45.           there   is   no   atom   _a_t_o_m   on   _t_k_w_i_n's  display,  then
  46.           TTTTkkkk____GGGGeeeettttAAAAttttoooommmmNNNNaaaammmmeeee returns the string ``?bad atom?''.
  47.  
  48.           Tk caches the  information  returned  by  TTTTkkkk____IIIInnnntttteeeerrrrnnnnAAAAttttoooommmm  and
  49.           TTTTkkkk____GGGGeeeettttAAAAttttoooommmmNNNNaaaammmmeeee so that future calls for the same information
  50.           can be  serviced  from  the  cache  without  contacting  the
  51.           server.  Thus TTTTkkkk____IIIInnnntttteeeerrrrnnnnAAAAttttoooommmm and TTTTkkkk____GGGGeeeettttAAAAttttoooommmmNNNNaaaammmmeeee are generally
  52.           much faster than their Xlib counterparts, and they should be
  53.           used in place of the Xlib procedures.
  54.  
  55.  
  56.      KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  57.           atom, cache, display
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/23/95)
  64.  
  65.  
  66.  
  67.